home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / Performer_demo / pfconv.z / pfconv
Text File  |  1998-10-30  |  12KB  |  265 lines
  1.  
  2.  
  3.  
  4. ppppffffccccoooonnnnvvvv((((1111ppppffff))))           IIIIRRRRIIIISSSS PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....2222 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss           ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppffffccccoooonnnnvvvv - IRIS Performer file translator
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppffffccccoooonnnnvvvv [ options ] infile1 [ infile2 ... ] outfile
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppffffccccoooonnnnvvvv is one of the sample programs distributed with the IRIS Performer
  16.      high-performance graphics library.  ppppffffccccoooonnnnvvvv loads one or more files into
  17.      an IRIS Performer scene graph, and then writes the resulting scene graph
  18.      out to a named output file.  It is installed in the /_u_s_r/_s_b_i_n directory.
  19.  
  20.      Currently, only the following formats support file writing:
  21.  
  22.  
  23.           dwb       Coryphaeus Software Designer's Workbench format
  24.  
  25.           medit     Medit productions modeler format
  26.  
  27.           pfa       IRIS Performer ASCII file format
  28.  
  29.           pfb       IRIS Performer high-speed binary file format
  30.  
  31.      Here's an example that generates a fast-loading IRIS Performer PFB format
  32.      file representing a Sierpinski sponge:
  33.  
  34.  
  35.           pfconv 2.sponge example.pfb
  36.           perfly example.pfb
  37.  
  38.  
  39.  
  40.      Preconverting files to the _p_f_b format can provide a great speed advantage
  41.      for demos and other applications where fast database loading is
  42.      important.
  43.  
  44.  
  45.  
  46.    ppppffffccccoooonnnnvvvv ccccoooommmmmmmmaaaannnndddd lllliiiinnnneeee ooooppppttttiiiioooonnnnssss
  47.           -b <mode>,<value>             -Set builder mode (default value is OFF)
  48.           -B <mode>,<value>             -Set builder mode (default value is ON)
  49.                               See the ppppffffddddBBBBllllddddrrrrMMMMooooddddeeee reference page
  50.                               for more information.
  51.               0 -> PFDBLDR_MESH_ENABLE
  52.               1 -> PFDBLDR_MESH_SHOW_TSTRIPS
  53.               2 -> PFDBLDR_MESH_INDEXED
  54.               3 -> PFDBLDR_MESH_MAX_TRIS
  55.               4 -> PFDBLDR_MESH_RETESSELLATE
  56.               5 -> PFDBLDR_MESH_LOCAL_LIGHTING
  57.              10 -> PFDBLDR_AUTO_COLORS
  58.                    0 -> PFDBLDR_COLORS_PRESERVE  + leave colors alone
  59.                    1 -> PFDBLDR_COLORS_MISSING   - make missing colors
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppffffccccoooonnnnvvvv((((1111ppppffff))))           IIIIRRRRIIIISSSS PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....2222 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss           ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  71.  
  72.  
  73.  
  74.                    2 -> PFDBLDR_COLORS_GENERATE  - make all colors
  75.                    3 -> PFDBLDR_COLORS_DISCARD   - toss existing colors
  76.              11 -> PFDBLDR_AUTO_NORMALS
  77.                    0 -> PFDBLDR_NORMALS_PRESERVE - leave normals alone
  78.                    1 -> PFDBLDR_NORMALS_MISSING  + make missing normals
  79.                    2 -> PFDBLDR_NORMALS_GENERATE - make all normals
  80.                    3 -> PFDBLDR_NORMALS_DISCARD  - toss existing normals
  81.              12 -> PFDBLDR_AUTO_TEXTURE
  82.                    0 -> PFDBLDR_TEXTURE_PRESERVE + leave texture coord alone
  83.                    1 -> PFDBLDR_TEXTURE_MISSING  - make missing texture coord
  84.                    2 -> PFDBLDR_TEXTURE_GENERATE - make all texture coord
  85.                    3 -> PFDBLDR_TEXTURE_DISCARD  - toss existing texture coord
  86.              13 -> PFDBLDR_AUTO_ORIENT
  87.                    0 -> PFDBLDR_ORIENT_PRESERVE  - leave normal and order alone
  88.                    1 -> PFDBLDR_ORIENT_NORMALS   - make normal match vertex order
  89.                    2 -> PFDBLDR_ORIENT_VERTICES  + make vertex order match normal
  90.              15 -> PFDBLDR_AUTO_DISABLE_TCOORDS_BY_STATE
  91.                    0 - dont remove tcoords if no texture specified
  92.                    1 - remove tcoords if no texture specified
  93.              16 -> PFDBLDR_AUTO_DISABLE_NCOORDS_BY_STATE
  94.                    0 - dont remove ncoords if no material specified
  95.                    1 - remove ncoords if no material specified
  96.              17 -> PFDBLDR_AUTO_LIGHTING_STATE_BY_NCOORDS
  97.                    0 - dont automatically set lighting enable based on presence of ncoords
  98.                    1 - automatically set lighting enable based on presence of ncoords
  99.              18 -> PFDBLDR_AUTO_LIGHTING_STATE_BY_MATERIALS
  100.                    0 - dont automatically set lighting enable based on presence of material
  101.                    1 - automatically set lighting enable based on presence of material
  102.              19 -> PFDBLDR_AUTO_TEXTURE_STATE_BY_TEXTURES
  103.                    0 - dont automatically set texture enable based on presence of tcoords
  104.                    1 - automatically set texture enable based on presence of tcoords
  105.              20 -> PFDBLDR_AUTO_TEXTURE_STATE_BY_TCOORDS
  106.                    0 - dont automatically set texture enable based on presence of texture
  107.                    1 - automatically set texture enable based on presence of texture
  108.              30 -> PFDBLDR_BREAKUP
  109.              31 -> PFDBLDR_BREAKUP_SIZE
  110.              32 -> PFDBLDR_BREAKUP_BRANCH
  111.              33 -> PFDBLDR_BREAKUP_STRIP_LENGTH
  112.              34 -> PFDBLDR_SHARE_MASK
  113.              35 -> PFDBLDR_ATTACH_NODE_NAMES
  114.              36 -> PFDBLDR_DESTROY_DATA_UPON_BUILD
  115.              37 -> PFDBLDR_PF12_STATE_COMPATIBLE
  116.              38 -> PFDBLDR_BUILD_LIMIT  -maximum number of tris/strip
  117.           -F <path>                     -Set file path
  118.           -n <notify>                   -Debug level
  119.           -o <mode>,<value>             -Set optimizer mode (default value is OFF)
  120.           -O <mode>,<value>             -Set optimizer mode (default value is ON)
  121.               0 -> pfdMakeShare                      defaults to ON
  122.               1 -> pfdCombineLayers                  defaults to ON
  123.               2 -> pfFlatten                         defaults to ON
  124.               3 -> pfdCleanTree                      defaults to ON
  125.               4 -> pfdCombineBillboards,<size_limit> defaults to OFF
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppffffccccoooonnnnvvvv((((1111ppppffff))))           IIIIRRRRIIIISSSS PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....2222 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss           ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  137.  
  138.  
  139.  
  140.               5 -> pfdFreezeTransforms               defaults to OFF
  141.               6 -> pfPartition                       defaults to OFF
  142.  
  143.  
  144.  
  145.      Examine the source code to ppppffffccccoooonnnnvvvv to understand the optimization
  146.      transformations that can be applied to files as they are loaded.  By
  147.      default, only safe optimizations are performed, but there are several
  148.      other optimizations, some quite aggressive, that can be enabled
  149.  
  150.  
  151.  
  152.    SSSSuuuuppppppppoooorrrrtttteeeedddd DDDDaaaattttaaaabbbbaaaasssseeee FFFFoooorrrrmmmmaaaattttssss
  153.      ppppffffccccoooonnnnvvvv, like all IRIS Performer applications, is able to directly load 3D
  154.      data in a large selection of popular formats and draw that data at high
  155.      speed.  All of the following file formats are understood by pfconv:
  156.  
  157.  
  158.           3ds       AutoDesk _3_D_S_t_u_d_i_o binary data
  159.           bin       Minor SGI format used by _p_o_w_e_r_f_l_i_p
  160.           bpoly     Side Effects Software _P_R_I_S_M_S binary
  161.           byu       Brigham Young University CAD/FEA data
  162.           dwb       Coryphaeus Software _D_e_s_i_g_n_e_r'_s _W_o_r_k_b_e_n_c_h
  163.           dxf       AutoDesk _A_u_t_o_C_A_D ASCII format
  164.           flt11     MultiGen public domain Flight v11 format
  165.           flt14     MultiGen _O_p_e_n_F_l_i_g_h_t v14 format
  166.           gds       McDonnell-Douglas GDS _t_h_i_n_g_s data
  167.           gfo       Minor SGI format (radiosity output)
  168.           im        Minor SGI format (IRIS Performer example)
  169.           irtp      AAI/Graphicon _I_n_t_e_r_a_c_t_i_v_e _R_e_a_l-_T_i_m_e _P_H_I_G_S
  170.           iv        SGI OpenInventor / Silicon Studio Keystone
  171.           lsa       Lightscape Technologies radiosity (ASCII)
  172.           lsb       Lightscape Technologies radiosity (binary)
  173.           m         University of Washington mesh data
  174.           medit     Medit Productions _m_e_d_i_t modeling tool
  175.           nff       Eric Haines' ray tracing test data format
  176.           obj       Wavefront Technologies data format
  177.           phd       Minor SGI format (polyhedra)
  178.           pfa       IRIS Performer ASCII database format
  179.           pfb       IRIS Performer BINARY database format
  180.           poly      Side Effects Software _P_R_I_S_M_S ASCII data
  181.           pts       University of Washington point data
  182.           ptu       Minor SGI format (IRIS Performer example)
  183.           sgf       US NAVY standard graphics format
  184.           sgo       Minor SGI format
  185.           spf       US NAVY simple polygon format
  186.           sponge    Sierpinski sponge 3D fractal generator
  187.           star      Yale University compact star chart data
  188.           stla      3D Structures Stereolithography (ASCII)
  189.           stlb      3D Structures Stereolithography (binary)
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ppppffffccccoooonnnnvvvv((((1111ppppffff))))           IIIIRRRRIIIISSSS PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....2222 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss           ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  203.  
  204.  
  205.  
  206.           sv        Format of John Kichury's _i_3_d_m modeler
  207.           tri       University of Minnesota Geometry Center data
  208.           unc       University of North Carolina data
  209.  
  210.  
  211.  
  212.    LLLLeeeeaaaarrrrnnnniiiinnnngggg MMMMoooorrrreeee
  213.      Once you've seen IRIS Performer in action, you will want to learn more
  214.      about it.  The IRIS Performer Programming Guide and the IRIS Performer
  215.      Release Notes are the primary sources of information, but the a number of
  216.      information sources are available to give you a good start in your
  217.      learning process. The origin of this quest is the Performer man page.
  218.      Just type "man performer" and just about everything you might want to
  219.      know will be there or in one of the on-line resources listed there.
  220.  
  221.  
  222. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  223.      ppppeeeerrrrffffoooorrrrmmmmeeeerrrr, ppppffffccccoooonnnnvvvv
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.